home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / graphic / hcshow15.zip / HCSHOW.DOC < prev    next >
Text File  |  1993-05-23  |  10KB  |  277 lines

  1.  
  2.  
  3.               H C   S H O W
  4.  
  5.                Version 1.5
  6.               May 20 , 1993
  7.  
  8.     A Targa(tm) and GIF(tm) Viewer for Tseng(tm) HiColor(tm) Cards
  9.  
  10. Copyright 1990,1991,1992 Synergrafix Consulting.  All Rights Reserved
  11.  
  12.      HCSHOW is produced by:
  13.  
  14.        Steve Enns            Synergrafix Consulting
  15.     44 Macdermid Cres.        - Custom Programming
  16.       Saskatoon, Sk.          - Graphical and Numerical Software
  17.       Canada S7J 2R2          - Hardware and Software Consultation
  18.  
  19.  
  20.     Donations gratefully accepted!  $10.00 will get you the latest
  21.     version of this program on disk!  Don't make me hunt you down
  22.     like a dog to scream shareware licenses into your face!
  23.  
  24.  
  25.     This program is dedicated to all those unemployed ray-tracing
  26.     artists out there who have the talent, skill (and time ;) to
  27.     create truly amazing images out of pixels and imaginary light.
  28.     (Miller and Brown - come to town, I'll buy you a beer - not 
  29.     tomorrow though, I'm washing my hair.)
  30.  
  31.  
  32. ACKNOWLEDGEMENTS
  33.  
  34.      Thanks to all the contributors to the absolutely superb graphics
  35.      books:
  36.  
  37.     Graphics Gems    Academic Press, Edited by Andrew S. Glassner, 1990,
  38.             ISBN 0-12-286165-5
  39.  
  40.     Graphics Gems II  Academic Press, Edited by James Arvo, 1991,
  41.               ISBN 0-12-064480-0
  42.  
  43.      Thanks as well to some greatly inspirational and explicit code
  44.      by Michael Abrash in the November 1991 Doctor Dobbs Journal.
  45.  
  46.      Finally, great thanks to Daniel Lee Crocker and the Stone Soup
  47.      Group for numerous tremendous contributions to the public good
  48.      through PICLAB, and FRACTINT (the best program ever written) both
  49.      containing very enlightening Targa(tm) file code.
  50.  
  51.      Thanks also to John Swenson who wrote TGVIEW, which encouraged me
  52.      to write this much faster and better program. ;-)
  53.  
  54.      Trademarks like GIF(tm) and PC(tm) are held by
  55.      their respective companies.
  56.  
  57.  
  58. DISCLAIMER
  59.  
  60.      The HCSHOW program is provided without warranty of any kind.  The
  61.      user of the HCSHOW package assumes complete responsibility for
  62.      any and all incidental or consequential damages which may occur
  63.      during normal or abnormal use of the HCSHOW package.  Use the
  64.      HCSHOW program at your own risk.
  65.  
  66.  
  67. LICENSE
  68.  
  69.      The HCSHOW program and documentation are Copyright 1990,1991,
  70.      1993 Synergrafix Consulting.  All rights reserved.  The HCSHOW
  71.      program may be freely distributed to others by any means, as
  72.      long the following (three) conditions are met:
  73.  
  74.       1) HCSHOW is distributed in a "package" containing
  75.       the following files:
  76.  
  77.         HCSHOW.EXE
  78.         HCSHOW.DOC
  79.         HCSREAD.ME
  80.  
  81.       2) HCSHOW is not distributed as part of any other
  82.       product, except with specific written permission from
  83.       the authors.
  84.  
  85.       3) NO fee of any kind is charged for the HCSHOW
  86.       package or for the service of providing the package,
  87.       except Computer Bulletin Board Systems or Services,
  88.       which may distribute the HCSHOW package even though they
  89.       may charge a membership or service fee.
  90.  
  91.  
  92.      Look for the HCSVGA library on your favorite bulletin board
  93.      system.  The HCSVGA has the Targa(tm), GIF(tm) and HiColor
  94.      support used by HCSHOW.
  95.  
  96.      (If you are seriously interested in the source code for the
  97.      HCSVGA library, then write me a letter with your proposed uses
  98.      for the code, and I'll return a quote for the price.  (Probably
  99.      $50.00-$100.00 with no royalties.)
  100.  
  101.  
  102. REQUIREMENTS
  103.  
  104.       HCSHOW requires the following:
  105.  
  106.            -    PC(tm)/XT(tm)/AT(tm)/386(tm) computer
  107.            -    TSENG 4000 based Video Card equipped with
  108.             at least 1 Megabyte of display memory, and
  109.             a Sierra HiColor(tm) DAC chip, or a ATI XL
  110.             HiColor equipped board, or a VESA compliant
  111.             board (like S3 based boards) with a HiColor
  112.             DAC.
  113.  
  114.       Optionally:
  115.  
  116.            -    A MS compatible mouse for the incredibly
  117.             confusing "Cursor Mode"
  118.  
  119.  
  120. USAGE
  121.  
  122.  
  123.      HCSHOW filespec[.GIF|.TGA] [outfilename[.TGA]] /dither /comp
  124.         /autoscale /mode=0..3 /text=str /giftag=giffile /comm=str
  125.         /nocomm /info /slide=n
  126.  
  127.      where:
  128.  
  129.     filename     - the Targa(tm) or GIF(tm) to display.
  130.     outfilename    - the Targa output filename (used to save dithered
  131.                 pics, see below.)
  132.     /dither        - dither the image if it is a 24 or 32 bit Targa(tm)
  133.     /comp        - compress the output Targa(tm) file
  134.     /autoscale    - try to scale the GIF(tm) to fit the screen
  135.     /mode=n        - force mode n.  Not all modes work with all cards.
  136.     /text=str    - display "str" when placing text in cursor mode.
  137.     /giftag=filename - display GIF "filename" when placing a GIF in
  138.                 cursor mode.
  139.     /comm=str    - display comment "str", and add it to the Targa when
  140.                 saving.
  141.     /nocomm        - don't display the Targa comment on the screen. (A
  142.                 comment can still be placed in the Targa
  143.                 with /COMM=str
  144.     /info        - display file information on the screen.
  145.     /slide=n      - do a slideshow of the specified files, waiting n
  146.                 seconds between each picture.
  147.     /l=x        - display the image cropped to the window
  148.     /t=y            bounded by (x,y) (left,top) to 
  149.     /r=x1            (x1,y1) (right,bottom).
  150.     /b=y1
  151.  
  152.  
  153. EXAMPLES
  154.  
  155.      HCSHOW is very easy to use.  When the picture is displayed, press
  156.      <ENTER> to save the current display as a Targa-16(tm), press "C"
  157.      to enter "cursor mode" (see below) or any other key to exit without
  158.      saving.
  159.  
  160.      C> HCSHOW picname
  161.  
  162.      will display "picname" on the screen in HiColor mode.  Looking
  163.      for "picname.gif" first, and then "picname.tga".
  164.  
  165.      or
  166.  
  167.      C> HCSHOW picname out.tga /dither /comp /mode=3
  168.  
  169.      will display "picname" using dithering and 800x600 mode, saving
  170.      the output (if any) to the file "out.tga"
  171.  
  172.      or
  173.  
  174.      C> HCSHOW a*.tga /dither /comp /mode=3 /text=Copyright~1992~SE
  175.         /giftag=mylogo.gif /comm=Copyright~1992~SE
  176.  
  177.      will display all the files "a*.tga", dithering when displaying
  178.      24 or 32 bit Targas, using 800x600 mode and placing the text
  179.      "Copyright 1992 SE" on the screen when using "cursor mode", and
  180.      into the Targa as a comment when a screen is saved....
  181.  
  182.  
  183. CURSOR MODE
  184.  
  185.      Sorry, I'm going to leave this explanation in its current in-
  186.      comprehensible state until I decide the future of this program.
  187.      In the meantime, have a stiff drink, and just read through it
  188.      really fast without stopping, and it will seem really obvious,
  189.      just like proofs from your graph theory class...
  190.  
  191.         Press "C" when a picture is displayed to enter cursor mode.
  192.      If you have a mouse (and mouse driver software) installed, you
  193.      will have a graphical cursor available to define rectangular areas
  194.      of the current screen image.  Press and hold the left mouse button
  195.      to start "dragging" a box to the desired size.  Release and re-press
  196.      the left button to restart another box.  Upon choosing a suitable
  197.      area with the "dragging box", press <ENTER> to use the current box
  198.      area for further operations, or press <ESC> to ignore the chosen box,
  199.      and return to the whole screen.  Both <ENTER> and <ESC> exit cursor
  200.      mode, and return to normal operation.  If you chose a box and pressed
  201.      <ENTER> you can now save the area within the box by pressing <ENTER>
  202.      again, or you can press <ESC> to exit or <SPACE> to go to the next
  203.      picture, if there is one.  So there.
  204.         Press the right mouse button when moving the mouse to activate
  205.      the text (specified with /TEXT=str).  This text can now be placed on
  206.      the screen by pressing the right mouse button when you are satisfied
  207.      with the position.  Press "G" when moving the cursor to display the
  208.      GIF (specified with /GIFTAG=giffile) a the current position.  This
  209.      feature is intended to allow placement of graphical logos saved as
  210.      GIFs onto Targa images as a "signature."
  211.         If you want to wreck the image, you can also press "I" to invert
  212.      the colours in the current area, or "r" "R" "g" "G" "b" "B" to
  213.      decrease or increase the red green or blue components of the colours
  214.      in the current area.
  215.  
  216.  
  217. HISTORY
  218.  
  219.      - Version 0.5b Completed December 20 1991
  220.  
  221.     Just a Beta version!  Lots more to be done...
  222.  
  223.      - Version 0.6b February 4 1992
  224.  
  225.     Output filenames are now properly recognized.  Maybe.
  226.  
  227.     Now compiled with Borland C 3.0 for extra speed,
  228.     especially when dithering Targa-24 files.
  229.  
  230.      - Version 1.0b April 4 1992
  231.  
  232.     Dithering of Targa-24's is faste